String

class String : Comparable<String> , CharSequence

The String class represents character strings. All string literals in Kotlin programs, such as "abc", are implemented as instances of this class.

Constructors

String

fun String()

Types

Companion

object Companion

Functions

compareTo

open operator override fun compareTo(other: String): Int

Compares this object with the specified object for order. Returns zero if this object is equal to the specified other object, a negative number if it's less than other, or a positive number if it's greater than other.

get

open operator override fun get(index: Int): Char

Returns the character of this string at the specified index.

plus

operator fun plus(other: Any?): String

Returns a string obtained by concatenating this string with the string representation of the given other object.

subSequence

open override fun subSequence(startIndex: Int, endIndex: Int): CharSequence

Returns a new character sequence that is a subsequence of this character sequence, starting at the specified startIndex and ending right before the specified endIndex.

Properties

length

open override val length: Int

Returns the length of this character sequence.

Extensions

byteInputStream

inline fun String.byteInputStream(charset: Charset = Charsets.UTF_8): ByteArrayInputStream

Creates a new byte input stream for the string.

capitalize

@DeprecatedSinceKotlin(warningSince = "1.5")

~~expect~~ ~~fun~~ String.~~capitalize~~(): String

Returns a copy of this string having its first letter titlecased using the rules of the default locale, or the original string if it's empty or already starts with a title case letter.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~fun~~ String.~~capitalize~~(~~locale~~: Locale): String

Returns a copy of this string having its first letter titlecased using the rules of the specified locale, or the original string if it's empty or already starts with a title case letter.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~actual~~ ~~fun~~ String.~~capitalize~~(): String

Returns a copy of this string having its first letter titlecased using the rules of the default locale, or the original string if it's empty or already starts with a title case letter.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~actual~~ ~~fun~~ String.~~capitalize~~(): String

Returns a copy of this string having its first letter titlecased using the rules of the default locale, or the original string if it's empty or already starts with a title case letter.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~actual~~ ~~fun~~ String.~~capitalize~~(): String

Returns a copy of this string having its first letter titlecased using the rules of the default locale, or the original string if it's empty or already starts with a title case letter.

codePointAt

inline fun String.codePointAt(index: Int): Int

Returns the character (Unicode code point) at the specified index.

codePointBefore

inline fun String.codePointBefore(index: Int): Int

Returns the character (Unicode code point) before the specified index.

codePointCount

inline fun String.codePointCount(beginIndex: Int, endIndex: Int): Int

Returns the number of Unicode code points in the specified text range of this String.

compareTo

expect fun String.compareTo(other: String, ignoreCase: Boolean = false): Int

Compares two strings lexicographically, optionally ignoring case differences.

actual fun String.compareTo(other: String, ignoreCase: Boolean = false): Int

Compares two strings lexicographically, optionally ignoring case differences.

actual fun String.compareTo(other: String, ignoreCase: Boolean = false): Int

concat

inline fun String.concat(str: String): String

contentEquals

inline fun String.contentEquals(charSequence: CharSequence): Boolean

Returns true if this string is equal to the contents of the specified CharSequence, false otherwise.

inline fun String.contentEquals(stringBuilder: StringBuffer): Boolean

Returns true if this string is equal to the contents of the specified StringBuffer, false otherwise.

cstr

val String.cstr: CValues<ByteVar>

decapitalize

@DeprecatedSinceKotlin(warningSince = "1.5")

~~expect~~ ~~fun~~ String.~~decapitalize~~(): String

Returns a copy of this string having its first letter lowercased using the rules of the default locale, or the original string if it's empty or already starts with a lower case letter.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~fun~~ String.~~decapitalize~~(~~locale~~: Locale): String

Returns a copy of this string having its first letter lowercased using the rules of the specified locale, or the original string, if it's empty or already starts with a lower case letter.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~actual~~ ~~fun~~ String.~~decapitalize~~(): String

Returns a copy of this string having its first letter lowercased using the rules of the default locale, or the original string if it's empty or already starts with a lower case letter.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~actual~~ ~~fun~~ String.~~decapitalize~~(): String

Returns a copy of this string having its first letter lowercased using the rules of the default locale, or the original string if it's empty or already starts with a lower case letter.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~actual~~ ~~fun~~ String.~~decapitalize~~(): String

Returns a copy of this string having its first letter lowercased using the rules of the default locale, or the original string if it's empty or already starts with a lower case letter.

drop

fun String.drop(n: Int): String

Returns a string with the first n characters removed.

dropLast

fun String.dropLast(n: Int): String

Returns a string with the last n characters removed.

dropLastWhile

inline fun String.dropLastWhile(predicate: (Char) -> Boolean): String

Returns a string containing all characters except last characters that satisfy the given predicate.

dropWhile

inline fun String.dropWhile(predicate: (Char) -> Boolean): String

Returns a string containing all characters except first characters that satisfy the given predicate.

encodeToByteArray

expect fun String.encodeToByteArray(): ByteArray

Encodes this string to an array of bytes in UTF-8 encoding.

expect fun String.encodeToByteArray(startIndex: Int = 0, endIndex: Int = this.length, throwOnInvalidSequence: Boolean = false): ByteArray

Encodes this string or its substring to an array of bytes in UTF-8 encoding.

actual fun String.encodeToByteArray(): ByteArray

Encodes this string to an array of bytes in UTF-8 encoding.

actual fun String.encodeToByteArray(startIndex: Int = 0, endIndex: Int = this.length, throwOnInvalidSequence: Boolean = false): ByteArray

Encodes this string or its substring to an array of bytes in UTF-8 encoding.

actual fun String.encodeToByteArray(): ByteArray

Encodes this string to an array of bytes in UTF-8 encoding.

actual fun String.encodeToByteArray(startIndex: Int = 0, endIndex: Int = this.length, throwOnInvalidSequence: Boolean = false): ByteArray

Encodes this string or its substring to an array of bytes in UTF-8 encoding.

actual fun String.encodeToByteArray(): ByteArray

Encodes this string to an array of bytes in UTF-8 encoding.

actual fun String.encodeToByteArray(startIndex: Int = 0, endIndex: Int = this.length, throwOnInvalidSequence: Boolean = false): ByteArray

Encodes this string or its substring to an array of bytes in UTF-8 encoding.

endsWith

expect fun String.endsWith(suffix: String, ignoreCase: Boolean = false): Boolean

actual fun String.endsWith(suffix: String, ignoreCase: Boolean = false): Boolean

Returns true if this string ends with the specified suffix.

actual fun String.endsWith(suffix: String, ignoreCase: Boolean = false): Boolean

Returns true if this string ends with the specified suffix.

actual fun String.endsWith(suffix: String, ignoreCase: Boolean = false): Boolean

Returns true if this string ends with the specified suffix.

equals

expect fun String?.equals(other: String?, ignoreCase: Boolean = false): Boolean

Returns true if this string is equal to other, optionally ignoring character case.

actual fun String?.equals(other: String?, ignoreCase: Boolean = false): Boolean

Returns true if this string is equal to other, optionally ignoring character case.

actual fun String?.equals(other: String?, ignoreCase: Boolean = false): Boolean

Returns true if this string is equal to other, optionally ignoring character case.

filter

inline fun String.filter(predicate: (Char) -> Boolean): String

Returns a string containing only those characters from the original string that match the given predicate.

filterIndexed

inline fun String.filterIndexed(predicate: (index: Int, Char) -> Boolean): String

Returns a string containing only those characters from the original string that match the given predicate.

filterNot

inline fun String.filterNot(predicate: (Char) -> Boolean): String

Returns a string containing only those characters from the original string that do not match the given predicate.

format

inline fun String.format(vararg args: Any?): String

Uses this string as a format string and returns a string obtained by substituting the specified arguments, using the default locale.

@DeprecatedSinceKotlin(hiddenSince = "1.4")

~~inline~~ ~~fun~~ String.~~format~~(~~locale~~: Locale, ~~vararg~~ ~~args~~: Any?): String

Uses this string as a format string and returns a string obtained by substituting the specified arguments, using the specified locale.

@JvmName(name = "formatNullable")

inline fun String.format(locale: Locale?, vararg args: Any?): String

Uses this string as a format string and returns a string obtained by substituting the specified arguments, using the specified locale. If locale is null then no localization is applied.

intern

inline fun String.intern(): String

Returns a canonical representation for this string object.

lowercase

expect fun String.lowercase(): String

Returns a copy of this string converted to lower case using Unicode mapping rules of the invariant locale.

inline fun String.lowercase(locale: Locale): String

Returns a copy of this string converted to lower case using the rules of the specified locale.

actual inline fun String.lowercase(): String

Returns a copy of this string converted to lower case using Unicode mapping rules of the invariant locale.

actual inline fun String.lowercase(): String

Returns a copy of this string converted to lower case using Unicode mapping rules of the invariant locale.

actual fun String.lowercase(): String

Returns a copy of this string converted to lower case using Unicode mapping rules of the invariant locale.

match

inline fun String.match(regex: String): Array<String>?

matches

fun String.matches(regex: String): Boolean

offsetByCodePoints

inline fun String.offsetByCodePoints(index: Int, codePointOffset: Int): Int

Returns the index within this string that is offset from the given index by codePointOffset code points.

orEmpty

inline fun String?.orEmpty(): String

Returns the string if it is not null, or the empty string otherwise.

padEnd

fun String.padEnd(length: Int, padChar: Char = ' '): String

Pads the string to the specified length at the end with the specified character or space.

padStart

fun String.padStart(length: Int, padChar: Char = ' '): String

Pads the string to the specified length at the beginning with the specified character or space.

partition

inline fun String.partition(predicate: (Char) -> Boolean): Pair<String, String>

Splits the original string into pair of strings, where first string contains characters for which predicate yielded true, while second string contains characters for which predicate yielded false.

plus

operator fun String?.plus(other: Any?): String

Concatenates this string with the string representation of the given other object. If either the receiver or the other object are null, they are represented as the string "null".

operator fun String?.plus(other: Any?): String

Concatenates this string with the string representation of the given other object. If either the receiver or the other object are null, they are represented as the string "null".

inline operator fun String?.plus(other: Any?): String

prependIndent

fun String.prependIndent(indent: String = " "): String

Prepends indent to every line of the original string.

reader

inline fun String.reader(): StringReader

Creates a new reader for the string.

refTo

fun String.refTo(index: Int): CValuesRef<COpaque>

regionMatches

fun String.regionMatches(thisOffset: Int, other: String, otherOffset: Int, length: Int, ignoreCase: Boolean = false): Boolean

Returns true if the specified range in this string is equal to the specified range in another string.

fun String.regionMatches(thisOffset: Int, other: String, otherOffset: Int, length: Int, ignoreCase: Boolean = false): Boolean

Returns true if the specified range in this string is equal to the specified range in another string.

removePrefix

fun String.removePrefix(prefix: CharSequence): String

If this string starts with the given prefix, returns a copy of this string with the prefix removed. Otherwise, returns this string.

removeRange

inline fun String.removeRange(startIndex: Int, endIndex: Int): String

Removes the part of a string at a given range.

inline fun String.removeRange(range: IntRange): String

Removes the part of a string at the given range.

removeSuffix

fun String.removeSuffix(suffix: CharSequence): String

If this string ends with the given suffix, returns a copy of this string with the suffix removed. Otherwise, returns this string.

removeSurrounding

fun String.removeSurrounding(prefix: CharSequence, suffix: CharSequence): String

Removes from a string both the given prefix and suffix if and only if it starts with the prefix and ends with the suffix. Otherwise returns this string unchanged.

fun String.removeSurrounding(delimiter: CharSequence): String

Removes the given delimiter string from both the start and the end of this string if and only if it starts with and ends with the delimiter. Otherwise returns this string unchanged.

replace

expect fun String.replace(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String

Returns a new string with all occurrences of oldChar replaced with newChar.

expect fun String.replace(oldValue: String, newValue: String, ignoreCase: Boolean = false): String

Returns a new string obtained by replacing all occurrences of the oldValue substring in this string with the specified newValue string.

actual fun String.replace(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String

Returns a new string with all occurrences of oldChar replaced with newChar.

actual fun String.replace(oldValue: String, newValue: String, ignoreCase: Boolean = false): String

Returns a new string obtained by replacing all occurrences of the oldValue substring in this string with the specified newValue string.

actual fun String.replace(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String

Returns a new string with all occurrences of oldChar replaced with newChar.

actual fun String.replace(oldValue: String, newValue: String, ignoreCase: Boolean = false): String

Returns a new string obtained by replacing all occurrences of the oldValue substring in this string with the specified newValue string.

actual fun String.replace(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String

Returns a new string with all occurrences of oldChar replaced with newChar.

actual fun String.replace(oldValue: String, newValue: String, ignoreCase: Boolean = false): String

Returns a new string obtained by replacing all occurrences of the oldValue substring in this string with the specified newValue string.

replaceAfter

fun String.replaceAfter(delimiter: Char, replacement: String, missingDelimiterValue: String = this): String

fun String.replaceAfter(delimiter: String, replacement: String, missingDelimiterValue: String = this): String

Replace part of string after the first occurrence of given delimiter with the replacement string. If the string does not contain the delimiter, returns missingDelimiterValue which defaults to the original string.

replaceAfterLast

fun String.replaceAfterLast(delimiter: String, replacement: String, missingDelimiterValue: String = this): String

fun String.replaceAfterLast(delimiter: Char, replacement: String, missingDelimiterValue: String = this): String

Replace part of string after the last occurrence of given delimiter with the replacement string. If the string does not contain the delimiter, returns missingDelimiterValue which defaults to the original string.

replaceBefore

fun String.replaceBefore(delimiter: Char, replacement: String, missingDelimiterValue: String = this): String

fun String.replaceBefore(delimiter: String, replacement: String, missingDelimiterValue: String = this): String

Replace part of string before the first occurrence of given delimiter with the replacement string. If the string does not contain the delimiter, returns missingDelimiterValue which defaults to the original string.

replaceBeforeLast

fun String.replaceBeforeLast(delimiter: Char, replacement: String, missingDelimiterValue: String = this): String

fun String.replaceBeforeLast(delimiter: String, replacement: String, missingDelimiterValue: String = this): String

Replace part of string before the last occurrence of given delimiter with the replacement string. If the string does not contain the delimiter, returns missingDelimiterValue which defaults to the original string.

replaceFirst

expect fun String.replaceFirst(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String

Returns a new string with the first occurrence of oldChar replaced with newChar.

expect fun String.replaceFirst(oldValue: String, newValue: String, ignoreCase: Boolean = false): String

Returns a new string obtained by replacing the first occurrence of the oldValue substring in this string with the specified newValue string.

actual fun String.replaceFirst(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String

Returns a new string with the first occurrence of oldChar replaced with newChar.

actual fun String.replaceFirst(oldValue: String, newValue: String, ignoreCase: Boolean = false): String

Returns a new string obtained by replacing the first occurrence of the oldValue substring in this string with the specified newValue string.

actual fun String.replaceFirst(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String

actual fun String.replaceFirst(oldValue: String, newValue: String, ignoreCase: Boolean = false): String

actual fun String.replaceFirst(oldChar: Char, newChar: Char, ignoreCase: Boolean = false): String

Returns a new string with the first occurrence of oldChar replaced with newChar.

actual fun String.replaceFirst(oldValue: String, newValue: String, ignoreCase: Boolean = false): String

Returns a new string obtained by replacing the first occurrence of the oldValue substring in this string with the specified newValue string.

replaceFirstChar

@JvmName(name = "replaceFirstCharWithChar")

inline fun String.replaceFirstChar(transform: (Char) -> Char): String

@JvmName(name = "replaceFirstCharWithCharSequence")

inline fun String.replaceFirstChar(transform: (Char) -> CharSequence): String

Returns a copy of this string having its first character replaced with the result of the specified transform, or the original string if it's empty.

replaceIndent

fun String.replaceIndent(newIndent: String = ""): String

Detects a common minimal indent like it does trimIndent and replaces it with the specified newIndent.

replaceIndentByMargin

fun String.replaceIndentByMargin(newIndent: String = "", marginPrefix: String = "|"): String

Detects indent by marginPrefix as it does trimMargin and replace it with newIndent.

replaceRange

inline fun String.replaceRange(startIndex: Int, endIndex: Int, replacement: CharSequence): String

Replaces the part of the string at the given range with the replacement char sequence.

inline fun String.replaceRange(range: IntRange, replacement: CharSequence): String

Replace the part of string at the given range with the replacement string.

reversed

inline fun String.reversed(): String

Returns a string with characters in reversed order.

slice

fun String.slice(indices: IntRange): String

Returns a string containing characters of the original string at the specified range of indices.

inline fun String.slice(indices: Iterable<Int>): String

Returns a string containing characters of the original string at specified indices.

startsWith

expect fun String.startsWith(prefix: String, ignoreCase: Boolean = false): Boolean

expect fun String.startsWith(prefix: String, startIndex: Int, ignoreCase: Boolean = false): Boolean

actual fun String.startsWith(prefix: String, ignoreCase: Boolean = false): Boolean

Returns true if this string starts with the specified prefix.

actual fun String.startsWith(prefix: String, startIndex: Int, ignoreCase: Boolean = false): Boolean

Returns true if a substring of this string starting at the specified offset startIndex starts with the specified prefix.

actual fun String.startsWith(prefix: String, ignoreCase: Boolean = false): Boolean

Returns true if this string starts with the specified prefix.

actual fun String.startsWith(prefix: String, startIndex: Int, ignoreCase: Boolean = false): Boolean

Returns true if a substring of this string starting at the specified offset startIndex starts with the specified prefix.

actual fun String.startsWith(prefix: String, ignoreCase: Boolean = false): Boolean

Returns true if this string starts with the specified prefix.

actual fun String.startsWith(prefix: String, startIndex: Int, ignoreCase: Boolean = false): Boolean

Returns true if a substring of this string starting at the specified offset startIndex starts with the specified prefix.

subSequence

~~inline~~ ~~fun~~ String.~~subSequence~~(~~start~~: Int, ~~end~~: Int): CharSequence

Returns a subsequence of this char sequence.

substring

fun String.substring(range: IntRange): String

Returns a substring specified by the given range of indices.

expect fun String.substring(startIndex: Int): String

expect fun String.substring(startIndex: Int, endIndex: Int): String

actual inline fun String.substring(startIndex: Int): String

Returns a substring of this string that starts at the specified startIndex and continues to the end of the string.

actual inline fun String.substring(startIndex: Int, endIndex: Int): String

Returns the substring of this string starting at the startIndex and ending right before the endIndex.

actual inline fun String.substring(startIndex: Int): String

actual inline fun String.substring(startIndex: Int, endIndex: Int): String

actual inline fun String.substring(startIndex: Int): String

Returns a substring of this string that starts at the specified startIndex and continues to the end of the string.

actual inline fun String.substring(startIndex: Int, endIndex: Int): String

Returns the substring of this string starting at the startIndex and ending right before the endIndex.

substringAfter

fun String.substringAfter(delimiter: Char, missingDelimiterValue: String = this): String

fun String.substringAfter(delimiter: String, missingDelimiterValue: String = this): String

Returns a substring after the first occurrence of delimiter. If the string does not contain the delimiter, returns missingDelimiterValue which defaults to the original string.

substringAfterLast

fun String.substringAfterLast(delimiter: Char, missingDelimiterValue: String = this): String

fun String.substringAfterLast(delimiter: String, missingDelimiterValue: String = this): String

Returns a substring after the last occurrence of delimiter. If the string does not contain the delimiter, returns missingDelimiterValue which defaults to the original string.

substringBefore

fun String.substringBefore(delimiter: Char, missingDelimiterValue: String = this): String

fun String.substringBefore(delimiter: String, missingDelimiterValue: String = this): String

Returns a substring before the first occurrence of delimiter. If the string does not contain the delimiter, returns missingDelimiterValue which defaults to the original string.

substringBeforeLast

fun String.substringBeforeLast(delimiter: Char, missingDelimiterValue: String = this): String

fun String.substringBeforeLast(delimiter: String, missingDelimiterValue: String = this): String

Returns a substring before the last occurrence of delimiter. If the string does not contain the delimiter, returns missingDelimiterValue which defaults to the original string.

take

fun String.take(n: Int): String

Returns a string containing the first n characters from this string, or the entire string if this string is shorter.

takeLast

fun String.takeLast(n: Int): String

Returns a string containing the last n characters from this string, or the entire string if this string is shorter.

takeLastWhile

inline fun String.takeLastWhile(predicate: (Char) -> Boolean): String

Returns a string containing last characters that satisfy the given predicate.

takeWhile

inline fun String.takeWhile(predicate: (Char) -> Boolean): String

Returns a string containing the first characters that satisfy the given predicate.

toBigDecimal

inline fun String.toBigDecimal(): BigDecimal

inline fun String.toBigDecimal(mathContext: MathContext): BigDecimal

Parses the string as a java.math.BigDecimal number and returns the result.

toBigDecimalOrNull

fun String.toBigDecimalOrNull(): BigDecimal?

fun String.toBigDecimalOrNull(mathContext: MathContext): BigDecimal?

Parses the string as a java.math.BigDecimal number and returns the result or null if the string is not a valid representation of a number.

toBigInteger

inline fun String.toBigInteger(): BigInteger

inline fun String.toBigInteger(radix: Int): BigInteger

Parses the string as a java.math.BigInteger number and returns the result.

toBigIntegerOrNull

fun String.toBigIntegerOrNull(): BigInteger?

fun String.toBigIntegerOrNull(radix: Int): BigInteger?

Parses the string as a java.math.BigInteger number and returns the result or null if the string is not a valid representation of a number.

toBoolean

@DeprecatedSinceKotlin(hiddenSince = "1.4")

~~expect~~ ~~fun~~ String.~~toBoolean~~(): Boolean

Returns true if the content of this string is equal to the word "true", ignoring case, and false otherwise.

expect fun String?.toBoolean(): Boolean

Returns true if this string is not null and its content is equal to the word "true", ignoring case, and false otherwise.

@DeprecatedSinceKotlin(hiddenSince = "1.4")

~~actual~~ ~~inline~~ ~~fun~~ String.~~toBoolean~~(): Boolean

Returns true if the content of this string is equal to the word "true", ignoring case, and false otherwise.

@JvmName(name = "toBooleanNullable")

actual inline fun String?.toBoolean(): Boolean

Returns true if this string is not null and its content is equal to the word "true", ignoring case, and false otherwise.

@DeprecatedSinceKotlin(hiddenSince = "1.4")

~~actual~~ ~~inline~~ ~~fun~~ String.~~toBoolean~~(): Boolean

Returns true if the content of this string is equal to the word "true", ignoring case, and false otherwise.

actual fun String?.toBoolean(): Boolean

Returns true if this string is not null and its content is equal to the word "true", ignoring case, and false otherwise.

@DeprecatedSinceKotlin(hiddenSince = "1.4")

~~actual~~ ~~inline~~ ~~fun~~ String.~~toBoolean~~(): Boolean

Returns true if the content of this string is equal to the word "true", ignoring case, and false otherwise.

actual inline fun String?.toBoolean(): Boolean

Returns true if this string is not null and its content is equal to the word "true", ignoring case, and false otherwise.

toBooleanStrict

fun String.toBooleanStrict(): Boolean

Returns true if the content of this string is equal to the word "true", false if it is equal to "false", and throws an exception otherwise.

toBooleanStrictOrNull

fun String.toBooleanStrictOrNull(): Boolean?

Returns true if the content of this string is equal to the word "true", false if it is equal to "false", and null otherwise.

toByte

expect fun String.toByte(): Byte

expect fun String.toByte(radix: Int): Byte

Parses the string as a signed Byte number and returns the result.

actual inline fun String.toByte(): Byte

actual inline fun String.toByte(radix: Int): Byte

Parses the string as a signed Byte number and returns the result.

actual fun String.toByte(): Byte

actual fun String.toByte(radix: Int): Byte

Parses the string as a signed Byte number and returns the result.

actual inline fun String.toByte(): Byte

actual inline fun String.toByte(radix: Int): Byte

Parses the string as a signed Byte number and returns the result.

toByteArray

inline fun String.toByteArray(charset: Charset = Charsets.UTF_8): ByteArray

Encodes the contents of this string using the specified character set and returns the resulting byte array.

toByteOrNull

fun String.toByteOrNull(): Byte?

fun String.toByteOrNull(radix: Int): Byte?

Parses the string as a signed Byte number and returns the result or null if the string is not a valid representation of a number.

toCharArray

expect fun String.toCharArray(): CharArray

Returns a CharArray containing characters of this string.

expect fun String.toCharArray(startIndex: Int = 0, endIndex: Int = this.length): CharArray

Returns a CharArray containing characters of this string or its substring.

inline fun String.toCharArray(destination: CharArray, destinationOffset: Int = 0, startIndex: Int = 0, endIndex: Int = length): CharArray

Copies characters from this string into the destination character array and returns that array.

actual inline fun String.toCharArray(): CharArray

Returns a CharArray containing characters of this string.

actual fun String.toCharArray(startIndex: Int = 0, endIndex: Int = this.length): CharArray

Returns a CharArray containing characters of this string or its substring.

actual fun String.toCharArray(): CharArray

Returns a CharArray containing characters of this string.

actual fun String.toCharArray(startIndex: Int = 0, endIndex: Int = this.length): CharArray

Returns a CharArray containing characters of this string or its substring.

actual fun String.toCharArray(): CharArray

Returns a CharArray containing characters of this string.

actual fun String.toCharArray(startIndex: Int = 0, endIndex: Int = this.length): CharArray

Returns a CharArray containing characters of this string or its substring.

toDouble

expect fun String.toDouble(): Double

Parses the string as a Double number and returns the result.

actual inline fun String.toDouble(): Double

Parses the string as a Double number and returns the result.

actual fun String.toDouble(): Double

Parses the string as a Double number and returns the result.

actual inline fun String.toDouble(): Double

Parses the string as a Double number and returns the result.

toDoubleOrNull

expect fun String.toDoubleOrNull(): Double?

Parses the string as a Double number and returns the result or null if the string is not a valid representation of a number.

actual fun String.toDoubleOrNull(): Double?

Parses the string as a Double number and returns the result or null if the string is not a valid representation of a number.

actual fun String.toDoubleOrNull(): Double?

Parses the string as a Double number and returns the result or null if the string is not a valid representation of a number.

actual fun String.toDoubleOrNull(): Double?

Parses the string as a Double number and returns the result or null if the string is not a valid representation of a number.

toFloat

expect fun String.toFloat(): Float

Parses the string as a Float number and returns the result.

actual inline fun String.toFloat(): Float

Parses the string as a Float number and returns the result.

actual inline fun String.toFloat(): Float

Parses the string as a Float number and returns the result.

actual inline fun String.toFloat(): Float

Parses the string as a Float number and returns the result.

toFloatOrNull

expect fun String.toFloatOrNull(): Float?

Parses the string as a Float number and returns the result or null if the string is not a valid representation of a number.

actual fun String.toFloatOrNull(): Float?

Parses the string as a Float number and returns the result or null if the string is not a valid representation of a number.

actual inline fun String.toFloatOrNull(): Float?

Parses the string as a Float number and returns the result or null if the string is not a valid representation of a number.

actual fun String.toFloatOrNull(): Float?

Parses the string as a Float number and returns the result or null if the string is not a valid representation of a number.

toInt

expect fun String.toInt(): Int

expect fun String.toInt(radix: Int): Int

Parses the string as an Int number and returns the result.

actual inline fun String.toInt(): Int

actual inline fun String.toInt(radix: Int): Int

Parses the string as an Int number and returns the result.

actual fun String.toInt(): Int

actual fun String.toInt(radix: Int): Int

Parses the string as an Int number and returns the result.

actual inline fun String.toInt(): Int

actual inline fun String.toInt(radix: Int): Int

Parses the string as an Int number and returns the result.

toIntOrNull

fun String.toIntOrNull(): Int?

fun String.toIntOrNull(radix: Int): Int?

Parses the string as an Int number and returns the result or null if the string is not a valid representation of a number.

toLong

expect fun String.toLong(): Long

expect fun String.toLong(radix: Int): Long

Parses the string as a Long number and returns the result.

actual inline fun String.toLong(): Long

actual inline fun String.toLong(radix: Int): Long

Parses the string as a Long number and returns the result.

actual fun String.toLong(): Long

actual fun String.toLong(radix: Int): Long

Parses the string as a Long number and returns the result.

actual inline fun String.toLong(): Long

actual inline fun String.toLong(radix: Int): Long

Parses the string as a Long number and returns the result.

toLongOrNull

fun String.toLongOrNull(): Long?

fun String.toLongOrNull(radix: Int): Long?

Parses the string as a Long number and returns the result or null if the string is not a valid representation of a number.

toLowerCase

@DeprecatedSinceKotlin(warningSince = "1.5")

~~expect~~ ~~fun~~ String.~~toLowerCase~~(): String

Returns a copy of this string converted to lower case using the rules of the default locale.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~inline~~ ~~fun~~ String.~~toLowerCase~~(~~locale~~: Locale): String

Returns a copy of this string converted to lower case using the rules of the specified locale.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~actual~~ ~~inline~~ ~~fun~~ String.~~toLowerCase~~(): String

Returns a copy of this string converted to lower case using the rules of the default locale.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~actual~~ ~~inline~~ ~~fun~~ String.~~toLowerCase~~(): String

Returns a copy of this string converted to lower case using the rules of the default locale.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~actual~~ ~~fun~~ String.~~toLowerCase~~(): String

Returns a copy of this string converted to lower case using the rules of the default locale.

toPattern

inline fun String.toPattern(flags: Int = 0): Pattern

Converts the string into a regular expression Pattern optionally with the specified flags from Pattern or'd together so that strings can be split or matched on.

toRegex

inline fun String.toRegex(): Regex

Converts the string into a regular expression Regex with the default options.

inline fun String.toRegex(option: RegexOption): Regex

Converts the string into a regular expression Regex with the specified single option.

inline fun String.toRegex(options: Set<RegexOption>): Regex

Converts the string into a regular expression Regex with the specified set of options.

toShort

expect fun String.toShort(): Short

expect fun String.toShort(radix: Int): Short

Parses the string as a Short number and returns the result.

actual inline fun String.toShort(): Short

actual inline fun String.toShort(radix: Int): Short

Parses the string as a Short number and returns the result.

actual fun String.toShort(): Short

actual fun String.toShort(radix: Int): Short

Parses the string as a Short number and returns the result.

actual inline fun String.toShort(): Short

actual inline fun String.toShort(radix: Int): Short

Parses the string as a Short number and returns the result.

toShortOrNull

fun String.toShortOrNull(): Short?

fun String.toShortOrNull(radix: Int): Short?

Parses the string as a Short number and returns the result or null if the string is not a valid representation of a number.

toUByte

fun String.toUByte(): UByte

fun String.toUByte(radix: Int): UByte

Parses the string as a signed UByte number and returns the result.

toUByteOrNull

fun String.toUByteOrNull(): UByte?

fun String.toUByteOrNull(radix: Int): UByte?

Parses the string as an UByte number and returns the result or null if the string is not a valid representation of a number.

toUInt

fun String.toUInt(): UInt

fun String.toUInt(radix: Int): UInt

Parses the string as an UInt number and returns the result.

toUIntOrNull

fun String.toUIntOrNull(): UInt?

fun String.toUIntOrNull(radix: Int): UInt?

Parses the string as an UInt number and returns the result or null if the string is not a valid representation of a number.

toULong

fun String.toULong(): ULong

fun String.toULong(radix: Int): ULong

Parses the string as a ULong number and returns the result.

toULongOrNull

fun String.toULongOrNull(): ULong?

fun String.toULongOrNull(radix: Int): ULong?

Parses the string as an ULong number and returns the result or null if the string is not a valid representation of a number.

toUpperCase

@DeprecatedSinceKotlin(warningSince = "1.5")

~~expect~~ ~~fun~~ String.~~toUpperCase~~(): String

Returns a copy of this string converted to upper case using the rules of the default locale.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~inline~~ ~~fun~~ String.~~toUpperCase~~(~~locale~~: Locale): String

Returns a copy of this string converted to upper case using the rules of the specified locale.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~actual~~ ~~inline~~ ~~fun~~ String.~~toUpperCase~~(): String

Returns a copy of this string converted to upper case using the rules of the default locale.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~actual~~ ~~inline~~ ~~fun~~ String.~~toUpperCase~~(): String

Returns a copy of this string converted to upper case using the rules of the default locale.

@DeprecatedSinceKotlin(warningSince = "1.5")

~~actual~~ ~~fun~~ String.~~toUpperCase~~(): String

Returns a copy of this string converted to upper case using the rules of the default locale.

toUShort

fun String.toUShort(): UShort

fun String.toUShort(radix: Int): UShort

Parses the string as a UShort number and returns the result.

toUShortOrNull

fun String.toUShortOrNull(): UShort?

fun String.toUShortOrNull(radix: Int): UShort?

Parses the string as an UShort number and returns the result or null if the string is not a valid representation of a number.

trim

inline fun String.trim(predicate: (Char) -> Boolean): String

Returns a string having leading and trailing characters matching the predicate removed.

fun String.trim(vararg chars: Char): String

Returns a string having leading and trailing characters from the chars array removed.

inline fun String.trim(): String

Returns a string having leading and trailing whitespace removed.

trimEnd

inline fun String.trimEnd(predicate: (Char) -> Boolean): String

Returns a string having trailing characters matching the predicate removed.

fun String.trimEnd(vararg chars: Char): String

Returns a string having trailing characters from the chars array removed.

inline fun String.trimEnd(): String

Returns a string having trailing whitespace removed.

trimIndent

fun String.trimIndent(): String

Detects a common minimal indent of all the input lines, removes it from every line and also removes the first and the last lines if they are blank (notice difference blank vs empty).

trimMargin

fun String.trimMargin(marginPrefix: String = "|"): String

Trims leading whitespace characters followed by marginPrefix from every line of a source string and removes the first and the last lines if they are blank (notice difference blank vs empty).

trimStart

inline fun String.trimStart(predicate: (Char) -> Boolean): String

Returns a string having leading characters matching the predicate removed.

fun String.trimStart(vararg chars: Char): String

Returns a string having leading characters from the chars array removed.

inline fun String.trimStart(): String

Returns a string having leading whitespace removed.

uppercase

expect fun String.uppercase(): String

Returns a copy of this string converted to upper case using Unicode mapping rules of the invariant locale.

inline fun String.uppercase(locale: Locale): String

Returns a copy of this string converted to upper case using the rules of the specified locale.

actual inline fun String.uppercase(): String

Returns a copy of this string converted to upper case using Unicode mapping rules of the invariant locale.

actual inline fun String.uppercase(): String

Returns a copy of this string converted to upper case using Unicode mapping rules of the invariant locale.

actual fun String.uppercase(): String

Returns a copy of this string converted to upper case using Unicode mapping rules of the invariant locale.

utf16

val String.utf16: CValues<UShortVar>

utf32

val String.utf32: CValues<IntVar>

utf8

val String.utf8: CValues<ByteVar>

wcstr

val String.wcstr: CValues<UShortVar>